Skip to content

docs(skill): verified anti-pattern deltas for formula + data authoring skills#1922

Merged
os-zhuang merged 1 commit into
mainfrom
docs/formula-data-skill-antipatterns
Jun 15, 2026
Merged

docs(skill): verified anti-pattern deltas for formula + data authoring skills#1922
os-zhuang merged 1 commit into
mainfrom
docs/formula-data-skill-antipatterns

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Continues the upstream "teach the AI the right pattern at the source" work (after #1921 for the automation skill) to the other two authoring skills.

Discipline: verified deltas only, no padding

Both skills are already mature — formula already documents the #1491 brace-in-CEL mistake + the dialect split + isBlank/null handling; data already warns that script validation is inverted. So this adds only the verified gaps from this session, not fabricated anti-patterns:

objectstack-formula — only the stdlib + CEL built-ins are callable; an UNKNOWN function (PRIOR(), legacy ISBLANK(), a typo'd isBlnk()) now fails objectstack build with a "no matching overload" type error, not a silent runtime no-op. Use previous.x / isBlank(). (#1877)

objectstack-data

Verification

Docs-only. pnpm check:skill-docs passes (generated docs derive from SKILL.md frontmatter, unchanged). Empty changeset.

🤖 Generated with Claude Code

…g skills

Continues the upstream "teach the AI the right pattern" work for the other two
authoring skills. Both were already strong (formula already documents the #1491
brace-in-CEL mistake + dialects + isBlank; data already warns about inverted
script validation), so this adds ONLY verified deltas from this season — no
fabricated/padded anti-patterns:

- objectstack-formula: only the stdlib + CEL built-ins are callable; an unknown
  function (PRIOR(), legacy ISBLANK(), a typo) now FAILS objectstack build
  ("no matching overload"), not a silent runtime no-op (#1877).
- objectstack-data: `multiple: true` lookup is an ARRAY column ≠ junction object
  — reference positionally `{record.tags.0}` (#1872); on insert an omitted
  optional field reads as null in validation predicates (#1871).

Docs-only; check:skill-docs passes (frontmatter-derived docs unaffected); empty changeset.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 15, 2026 3:57pm

Request Review

@os-zhuang
os-zhuang merged commit 9ff4b9a into main Jun 15, 2026
13 checks passed
@os-zhuang
os-zhuang deleted the docs/formula-data-skill-antipatterns branch June 15, 2026 15:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant